home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / tttar.z / tttar
Text File  |  1998-10-30  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. ttttttttttttaaaarrrr((((1111))))                                                              ttttttttttttaaaarrrr((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      tttar - (de)archive files and ToolTalk objects
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ttttttttttttaaaarrrr {{{{cccc||||tttt||||xxxx}}}} [ ffffhhhhppppvvvv ] [ _t_a_r_f_i_l_e ] _p_a_t_h_n_a_m_e ...
  13.  
  14.      ttttttttttttaaaarrrr {{{{cccc||||tttt||||xxxx}}}} ffffLLLL [ hhhhppppRRRRvvvv ] _t_t_t_a_r_f_i_l_e [[ ----rrrreeeennnnaaaammmmeeee _o_l_d_n_a_m_e _n_e_w_n_a_m_e ] ...  ]
  15.      _p_a_t_h_n_a_m_e ...
  16.  
  17.      ttttttttttttaaaarrrr ----vvvv
  18.  
  19.      ttttttttttttaaaarrrr ----hhhh[[[[eeeellllpppp]]]]
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      ttttttttttttaaaarrrr has two fundamentally different modes.  Without the LLLL function
  23.      modifier, ttttttttttttaaaarrrr acts as a ToolTalk-aware wrapper for ttttaaaarrrr(1), archiving
  24.      (or extracting) multiple files and their TT objects onto (or from) a
  25.      single archive, called a _t_a_r_f_i_l_e. With the LLLL function modifier, ttttttttttttaaaarrrr
  26.      does not invoke ttttaaaarrrr to archive actual files, but instead archives (or
  27.      extracts) only TT objects onto (or from) a single archive, called a
  28.      _t_t_t_a_r_f_i_l_e. Since without the LLLL function modifier ttttttttttttaaaarrrr acts like an TT-
  29.      aware ttttaaaarrrr(1), the discussion below will be phrased as if the LLLL function
  30.      modifier is in effect.  That is, we will refer to _t_t_t_a_r_f_i_l_e_s instead of
  31.      _t_a_r_f_i_l_e_s, and we will discuss (de)archiving only "the TT objects of the
  32.      named files" rather than (de)archiving both "the named files _a_n_d their TT
  33.      objects".
  34.  
  35.      ttttttttttttaaaarrrr's actions are controlled by the first argument, the _k_e_y, a string
  36.      of characters containing exactly one function letter from the set ccccttttxxxx,
  37.      and one or more of the optional function modifiers listed below.  Other
  38.      arguments to ttttttttttttaaaarrrr are file or directory names that specify which files
  39.      to archive or extract TT objects for.  By default, the appearance of a
  40.      directory name refers recursively to the files and subdirectories of that
  41.      directory.
  42.  
  43. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN LLLLEEEETTTTTTTTEEEERRRRSSSS
  44.      cccc    Create a new _t_t_t_a_r_f_i_l_e and write the TT objects of the named files
  45.           onto it.
  46.  
  47.      tttt    List the table of contents of the _t_t_t_a_r_f_i_l_e.
  48.  
  49.      xxxx    Extract the TT objects of the named files from the _t_t_t_a_r_f_i_l_e.  If a
  50.           named file matches a directory with contents written onto the tape,
  51.           this directory is (recursively) extracted.  The owner and
  52.           modification time of the TT objects are restored (if possible).  If
  53.           no _f_i_l_e_n_a_m_e arguments are given, the TT objects of all files named
  54.           in the archive are extracted.
  55.  
  56. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN MMMMOOOODDDDIIIIFFFFIIIIEEEERRRRSSSS
  57.      ffff    Use the next argument as the name of the _t_t_t_a_r_f_i_l_e.  If _t_t_t_a_r_f_i_l_e is
  58.           given as `----', ttttttttttttaaaarrrr writes to the standard output or reads from the
  59.           standard input, whichever is appropriate.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ttttttttttttaaaarrrr((((1111))))                                                              ttttttttttttaaaarrrr((((1111))))
  71.  
  72.  
  73.  
  74.      hhhh    Follow symbolic links as if they were normal files or directories.
  75.           Normally, ttttttttttttaaaarrrr does not follow symbolic links.
  76.  
  77.      pppp    Preserve.  Restore the named files to their original modes, ignoring
  78.           the present uuuummmmaaaasssskkkk(2).  SetUID and sticky information are also
  79.           extracted if you are the super-user.  This option is only useful
  80.           with the xxxx function letter, and has no meaning if the LLLL function
  81.           letter is given.
  82.  
  83.      LLLL    Do not invoke ttttaaaarrrr(1).  Must be used with the ffff function modifier,
  84.           since reading and writing an ttttttttttttaaaarrrr archive directly to or from
  85.           magnetic tape is unimplemented.
  86.  
  87.      RRRR    Do not recurse into directories.  Valid only with the LLLL function
  88.           modifier.
  89.  
  90.      vvvv    Verbose.  Normally ttttttttttttaaaarrrr does its work silently; this option
  91.           displays the name of each file ttttttttttttaaaarrrr treats, preceded by the
  92.           function letter.
  93.  
  94. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  95.      ----rrrreeeennnnaaaammmmeeee
  96.           Takes the next two arguments as an _o_l_d_n_a_m_e and a _n_e_w_n_a_m_e,
  97.           respectively, and renames any entry archived as _o_l_d_n_a_m_e to _n_e_w_n_a_m_e.
  98.           If _o_l_d_n_a_m_e is a directory, then its entries are recursively renamed,
  99.           as well.  If more than one ----rrrreeeennnnaaaammmmeeee option applies to an entry
  100.           (because of 1 or more parent directories being renamed), the most
  101.           specific ----rrrreeeennnnaaaammmmeeee option applies.  The ----rrrreeeennnnaaaammmmeeee option is only allowed
  102.           with the LLLL function modifier.
  103.  
  104.      ----hhhh   Print usage information for ttttttttttttaaaarrrr.
  105.  
  106.      ----vvvv   Print the version of ttttttttttttaaaarrrr.
  107.  
  108. FFFFIIIILLLLEEEESSSS
  109.      ////mmmmoooouuuunnnnttttppppooooiiiinnnntttt////TTTTTTTT____DDDDBBBB        This directory is used as a database for the
  110.                               ToolTalk objects of files in the filesystem
  111.                               mounted at /_m_o_u_n_t_p_o_i_n_t.
  112.  
  113. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  114.      ttttaaaarrrr(1), ttttttttccccooooppppyyyy(1), ttttttttsssseeeessssssssiiiioooonnnn(1), ttttttttddddbbbbcccckkkk(8)
  115.  
  116. BBBBUUUUGGGGSSSS
  117.      When extracting from a ttttaaaarrrr archive that is given to ttttttttttttaaaarrrr either on
  118.      magnetic tape or on the standard input, the current working directory
  119.      must be writable, so that the _t_t_t_a_r_f_i_l_e can be placed there temporarily.
  120.  
  121.      Writing and reading _t_t_t_a_r_f_i_l_e_s (i.e., archives produced with the LLLL
  122.      function modifier) directly to and from magnetic tape is unimplemented.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ttttttttttttaaaarrrr((((1111))))                                                              ttttttttttttaaaarrrr((((1111))))
  137.  
  138.  
  139.  
  140.      The rrrr and uuuu function letters of ttttaaaarrrr(1), for incrementally updating an
  141.      archive, are not supported.
  142.  
  143.      The XXXX and FFFF function modifiers and the ----IIII option of ttttaaaarrrr(1), for including
  144.      or excluding files from being archived based on SCCS status or being
  145.      listed in a special file, are not supported.
  146.  
  147.      The wwww function modifier and the ----CCCC option of ttttaaaarrrr(1), for pausing or
  148.      changing directories between the files listed on the command line, are
  149.      not supported.
  150.  
  151.      A file does not have to exist for an TT object to be associated with its
  152.      pathname. When ttttttttttttaaaarrrr descends into a directory, it does not attempt to
  153.      archive the objects associated with any files that do not exist in the
  154.      directory.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.